home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / patches / hsmoda07 / hsm_doku / 1_readme.eng next >
Text File  |  1994-05-16  |  9KB  |  215 lines
  1. Modular (Serial) Device Drivers
  2. ===============================
  3.  
  4. >> HSMODA07.LZH is a kind of intermediate release. It provides the current 
  5. state of development to all users. There are some bug fixes. Sorry, but 
  6. the English documentation is a bit outdated. <<
  7.  
  8. Attention! On 1994-12-30 I made a larger change. Only DRVIN and drivers
  9. all written before the 1994-12-30 or all written on and after this date
  10. will work togehter.
  11.  
  12. This package contains serial drivers. For every interface or every
  13. interface integrated circuit exist an own driver. The user has to deal
  14. with selecting the right drivers, but the advantage to load only the
  15. drivers he needs. Because I use a clean modular design, a special program
  16. (DRVIN.PRG) has to be loaded before the real drivers. This program adds
  17. the functions for driver installations, which are absent in the operating
  18. system (TOS, Mag!X, MiNT).
  19.  
  20. Order
  21. -----
  22. DRVIN.PRG has to be loaded before the drivers. DRVIN lays best in the
  23. \AUTO\-folder together with the drivers. It should be loaded as late as
  24. possible because of speed reasons, but before the drivers. DRVIN and the
  25. drivers must be loaded before programs installed in the \AUTO\, which want
  26. use the drivers. DRVIN.PRG is described in DRVIN.TXT. The drivers are
  27. named according to the names of the interfaces or interface ICs and
  28. described in the *.TXT-files with similar names.
  29.  
  30. With TOS version 2.0 or greater or a good shell it's easy to watch the
  31. real order in the \AUTO\ by switching the display to "unordered /
  32. unsorted". Under older TOS desktops you have to move all programs from
  33. \AUTO\ into an other folder, so that \AUTO\ is empty, and then copy the
  34. programs back into \AUTO\ in the wished order.
  35.  
  36. DRVIN shall be startet after the following programs if they are used,
  37. because otherwise problems could occur:
  38. - Overscan-driver (if TOS1.4-fix is on)
  39. - FPATCH2.PRG on Falcon (FPATCH1.PRG should not be used in general)
  40.  
  41.  
  42. Configuration
  43. -------------
  44. The selection of the drivers by the user allows a part of adaption to the
  45. own system. A more individual adjustment of the drivers is often necessary
  46. because of the various hardware(enhancements), but too because of dirty
  47. software. These settings are saved direct in the drivers. The driver
  48. contains additionally a short (German) explaination to every configuration
  49. point. More information (English too) is contained in the *.TXT to the
  50. driver.
  51.  
  52. The configuration is done by the program SETTER.TTP included in this
  53. package. It is described in SETTER.TXT. From TOS1.04 up the use of SETTER
  54. is simple: Take the program to modify with the mouse and drag it on
  55. SETTER.TTP. SETTER will start, load the programm and start the
  56. configuration dialog or give a message, that configuration is impossible
  57. because the program doesn't contain any settings. For older versions of
  58. TOS: doubleclick SETTER.TTP and enter the name and path of the program in
  59. the appearing dialog box.
  60.  
  61.  
  62. HSMODEM1 (-compatibility)
  63. -------------------------
  64. These drivers replace HSMODEM1. The BIOS function calls for MODEM1 are
  65. because of the support of several interfaces a very little bit slower than
  66. in HSMODEM1. Who uses exclusively a old program together with the last
  67. HSMODEM1 version (HSMOD105.LZH), is not in need of updating to these
  68. drivers.
  69.  
  70. If MFP.PRG is loaded as the only or the last driver, all old programs,
  71. running with the HSMODEM1 versions, should work with MFP.PRG too.
  72.  
  73.  
  74. Short Instruction
  75. -----------------
  76. This chapter shall describe the installation under TOS and Mag!X as short
  77. and clear as possible. It should be seen as program and "executed" from
  78. the start to the end.
  79.  
  80. You found in a program you want to use the hint that these drivers are
  81. necessary or will provide enhancements. You have any other reason for
  82. installing these drivers. If you have no reason for installation, you
  83. should read this text without "action".
  84.  
  85. If you have any program in the \AUTO\-folder which uses the serial
  86. interfaces, move it out from the \AUTO\.
  87.  
  88. Remove any installed patch programs for the serial interfaces, eg.
  89. RS232ENC, TURBOCTS, SERIALFX, from \AUTO\.
  90.  
  91. Select the drivers you need of this package. The following hints shall
  92. help you:
  93.  
  94. Basic equipment:
  95. for ST, STE, MegaST: MFP.PRG
  96. for MegaSTE:         MFP.PRG, SCC.PRG
  97. for TT:              MFP.PRG, SCC.PRG, MFP_TT.PRG
  98. for Falcon:          SCC.PRG
  99.  
  100. Additional or extended equipment:
  101.  If you replaced the original 85C30 in your MegaSTE, TT or Falcon by an
  102. Am85C230A or Z85230, you can use ESCC.PRG instead of SCC.PRG. In the state
  103. of delivery these computers contain only a SCC, then use the SCC.PRG.
  104.  If you modified your falcon by drawing out the MODEM1 interface not
  105. existent in the original state, you can use additionally MFP_FALC.PRG for
  106. this interface.
  107.  Who installed the hardware ST_ESCC in his computer, uses additionally
  108. ST_ESCC.PRG.
  109.  Who has other interface modifications, should read the textes and may ask
  110. me, if he finds nothing.
  111.  
  112. The configuration of the selected drivers is done by using SETTER.TTP, see
  113. "Configuration" for details. You have to respond to the questions and
  114. decide something. Often you can use the standard settings. If you need
  115. additional information, you will find it in the *.TXT-files which are
  116. named similar the drivers, eg. in MFP.TXT are informations about
  117. MFP_FALC.PRG.
  118.  
  119. You copy DRVIN.PRG into the \AUTO\-folder. You copy the selected and
  120. prepared drivers into \AUTO\. The order of the drivers is unimportant
  121. (hoping, that the user programs are modern and error free, otherwise this
  122. statement can be false).
  123.  
  124. The installation is complete. Reboot your computer and test the drivers.
  125. When it runs correctly, copy the serial interface using program you
  126. removed at the beginning back into \AUTO\.
  127.  
  128.  
  129. Copyright
  130. ---------
  131. This driver package may be freely copied under the following conditions:
  132. - The documentation(s) and drivers are copied unchanged.
  133. - The copies are free of charge or at the same price level as a PD-Disc.
  134. - The distribution together with PD- and Shareware products is generally
  135.   permitted.
  136. - The distribution together with commercial products is permitted. But the
  137.   distributor or programmer has to inform me (email is sufficent).
  138. - Please copy single files only in exceptional situations because the
  139.   first time user can't work with uncomplete packages.
  140.  
  141. Translations in other languages are expressly wished. But the German
  142. original must stay included into the package.
  143.  
  144. Who wants to add files, has to mark these as his Addition.
  145.  
  146. I'm interested in an error free version of this software. I tested it in
  147. the range of my opportunities. If errors occur, please send a detailed
  148. report to my email- or post address. I can fix only bugs I can reproduce
  149. or find by the description.
  150.  
  151. I'm not liable for any effects or no-effects equal of which kind caused by
  152. the use or no-use of this package in part or whole.
  153.  
  154. Trademarks and Registered Trademarks are used without warrantee of free
  155. usability.
  156.  
  157. These drivers and documentations I wrote in my spare time. There is no
  158. firm, which pays me for that. My activities are supported by the
  159. programmers using my drivers and the users sending me (good) bug reports.
  160. At this place I want to thank these persons and append an appeal: If
  161. somebody finds a mistake in these texts, wrote a good example program he
  162. wants to publish, made the describtion better or more intelligible or
  163. translated it, he/she/it should inform me. I'm interested in including
  164. correct addings and programs. (I'm a friend of complete documentations,
  165. others like examples more.)
  166.  
  167. My addresses:
  168. Mausnet: Harun Scheutzow @B
  169. Internet: Harun_Scheutzow@b.maus.de
  170. (Because of the limitations in the mausnet, PLEASE DON'T send mails
  171. greater than 16kbyte)
  172. Post address:
  173. Harun Scheutzow
  174. Dresdener Straže 83
  175. D-10179 Berlin, Germany
  176.  
  177. Translation
  178. -----------
  179.  
  180. This documentation was translated to English by Harun Scheutzow and
  181. Stefan Damerau
  182. For comments about the translation send mail to:
  183. MausNet:  Stefan Damerau @ SL
  184. Internet: cookie@cookie.syd.de
  185.       (or stefan_damerau@sl.maus.de but only mail < 16kB!!!)
  186. Post address:
  187. Stefan Damerau
  188. Bergholm 31
  189. D-24857 Fahrdorf, Germany
  190.  
  191.  
  192. Further Files
  193. -------------
  194. The programm SETTER with documentation.
  195. The description of the RSVF-Cookie RSVF_COO.TXT.
  196. The proposal for a hardwareindependent softwareinterface to serial (and
  197. similar) interfaces SERSOFST.TXT, which contains a German and an English
  198. version.
  199.  
  200.  
  201. Versions
  202. --------
  203. I give no version numbers, but use the date of the program printed out
  204. during installation as criterion. I note the date as year-month-day with
  205. an year number of four digits. The file date is only a bad replacement
  206. because it can change during copying.
  207.  
  208. New versions are to find first in the Maus Berlin3, telefon number 
  209. +49-30-6249514 (very often busy) an will spread about the Maus boxes. If I 
  210. have the opportunity, I put the current version on the internet-server 
  211. atari.archive.umich.edu. It should be looked for the file "HSMOD*.*". The 
  212. archiv is named HSMODAxx, where A stands for all serial interfaces and xx 
  213. for a running publication number.
  214.  
  215. ---EOF---